home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr56 / tchest11.zip / TC_FILES.ZIP / MANUAL.DOC < prev    next >
Text File  |  1993-06-21  |  22KB  |  529 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                               ------------------
  14.                               ToyCHEST I   v1.1a
  15.                               ------------------
  16.  
  17.                         Icon based menuing system (GUI)
  18.  
  19.                             Copyright (c) 1993 by:
  20.  
  21.                              jwh: SoftWare
  22.                              6947 Haggerty Road
  23.                              Hillsboro, Ohio  45133
  24.                              1(513)393-2402
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.               ToyCHEST I  allows up to 20  menus or  applications  on each
  36.               page.  You are  allowed to have  Sub Menus  and Applications
  37.               mixed on any page. Menus can be four levels deep.
  38.  
  39.               With this configuration, you can have up to 160,000 titles.
  40.  
  41.               Sub Menus are  titled as "M" and  Applications are titled
  42.               as "F".
  43.  
  44.               If a title is  password  protected,   a red bar  will appear
  45.               beneath the Menu or File prompt.
  46.  
  47.               NOTE !  All references to  "Click"  means to click your left
  48.               mouse button on the option.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. -
  67.               
  68.               
  69.               
  70.               
  71.               
  72.               Adding a Sub Menu or Application.
  73.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  74.               Click on the F1 Icon.
  75.  
  76.               Click on Create New.
  77.  
  78.               At the data entry screen:
  79.  
  80.               Title:  Enter a title for this menu or application.
  81.               ~~~~~~
  82.         
  83.               HotKey:  This hotkey  can be  used to  access  this menu  or
  84.               ~~~~~~~  application using the keyboard.
  85.         
  86.               Drive:  Enter the Drive letter this application is on. Click
  87.               ~~~~~~  on PgDn to list drives.
  88.               
  89.               Directory:  Enter the  Directory  that  this  application is
  90.               ~~~~~~~~~~  located in. Click on PgDn to list Directories.
  91.  
  92.               Command:  Enter  any  DOS  or  Batch  file  command  or  the
  93.               ~~~~~~~~  filename that executes  the application.  Click on
  94.                         PgDn to list files.
  95.                         
  96.                         You  may  enter any  number of  commands you
  97.                         like as  long as  you separate each  command
  98.                         with  a carat  character  (^).  Each command
  99.                         will be executed separately.
  100.  
  101.                         Always  include the  file  extensions (.COM,
  102.                         .EXE,.BAT) when entering filenames.
  103.  
  104.                         You may  also  include a  plus character (+)
  105.                         immediately following any command. Including
  106.                         a plus  character  will instruct  ToyCHEST I
  107.                         to ask the user for a command line switch or
  108.                         parameter  at  run  time.    Any  number  of
  109.                         commands may include a plus character.
  110.  
  111.                         You  may also  include  the word "DROP" as a
  112.                         command  on  this  line.   This DROP command
  113.                         will instruct ToyCHEST I to drop to DOS.
  114.  
  115.               Prompt:  Any  text entered  here will  be  displayed  to the
  116.               ~~~~~~~  user at runtime.
  117.  
  118.               Pause:  If  you  want  ToyCHEST I  to pause  and  wait for a
  119.               ~~~~~~  keypress after displaying the  above prompt,  answer
  120.                       this with a "Y".
  121.  
  122.               Password:  Enter a password here, only if you want this menu
  123.               ~~~~~~~~~  or application password protected.
  124.                
  125.                 
  126.                 
  127.                 
  128.                 
  129.                                        Page 1
  130.                 
  131.                 
  132. -                
  133.                 
  134.  
  135.                
  136.               CAUTION !   Even   blank   characters  can  be  used  as
  137.                           password  characters so  if you do  not want
  138.                           password protection, make sure no characters
  139.                           or blank spaces are present here.
  140.  
  141.               SHELL:  Answering this with a "N" will  instruct  ToyCHEST I
  142.               ~~~~~~  to totally drop out of system memory when  executing
  143.                       an application (the preferred method).
  144.  
  145.                       Answering with  a "Y" will  instruct  ToyCHEST I  to
  146.                       execute this  application  through a  shell to  DOS.
  147.                       With this method, ToyCHEST I  will use about  60k of
  148.                       system memory during execution of an application.
  149.  
  150.                       NOTE !  The SHELL method is slightly faster. Also if
  151.                               you are running ToyCHEST I  through  another
  152.                               GUI or menu  you may need to use  this SHELL
  153.                               method to make sure ToyCHEST I returns after
  154.                               executing a command.
  155.                      
  156.               MENU: Answering this option with a "Y" will cause this title
  157.               ~~~~~ to become a sub menu title.  You are  allowed to  have
  158.                     sub menus four levels deep. If you use this title as a
  159.                     sub menu, you  need not  enter any text or information
  160.                     at the  Drive, Directory, Command, or Prompt fields.
  161.                     The HotKey will be the only active field.
  162.  
  163.                     Answering with a "N" will instruct ToyCHEST I to treat
  164.                     this title  as an application entry (File).
  165.  
  166.               Icon: Enter the complete path and filename of the  256 color
  167.               ~~~~~ Icon you want displayed with this title. Click on PgDn
  168.                     to list the drive, directory and Icon list. When Icons
  169.                     are displayed in  this list,   you may  select one  by
  170.                     clicking your left mouse button on the Icon.
  171.  
  172.               After completing  all fields,  click on the  "TAB"  icon  to
  173.               save the field information.
  174.  
  175.               After saving  this title,   ToyCHEST I  will place  your new
  176.               title on  the display screen,  normally at  the lower  right
  177.               hand corner. You  may then  move or  relocate this new entry
  178.               by  clicking on F1 and then click on Move Icon,   then click
  179.               on the new Icon, move it around  the screen to the  location
  180.               you like,  and then click  your left mouse  button again  to
  181.               paste it down at the new location.
  182.  
  183.               Editing or changeing a Sub Menu or Application.
  184.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  185.               Click on the F1 Icon.
  186.  
  187.               Click on Edit Existing.
  188.  
  189.               Click on the Menu or Application title you want to edit.
  190.  
  191.               Make all the changes you like.
  192.  
  193.               Click on the TAB Icon to save your changes.
  194.  
  195.                                        Page 2
  196.  
  197.  
  198. -
  199.  
  200.  
  201.  
  202.               Deleting a Sub Menu or Application.
  203.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  204.               Click on the F1 Icon.
  205.  
  206.               Click on Delete Existing.
  207.   
  208.               Click on the Menu or Application you want deleted.
  209.  
  210.               NOTE !  If deleting  a Sub Menu,  all  sub  menus  and  file
  211.                       selections  associated  with  the deleted  menu will
  212.                       will also be deleted.
  213.  
  214.              The Move Selection option.
  215.               ~~~~~~~~~~~~~~~~~~~~~~~~~~
  216.               This  move option  allows  moving  the  Menu and  File  Icon
  217.               buttons around on your screen.
  218.  
  219.               To Move Menu or File selection.
  220.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  221.               Click on the F1 Icon.
  222.  
  223.               Click on Move Selection.
  224.  
  225.               Click on the Menu or File Icon that you want to move.
  226.  
  227.               Move the Icon with your mouse to the new location.
  228.  
  229.               Click your left mouse button to paste it down.
  230.  
  231.               The Setup Defaults option.
  232.               ~~~~~~~~~~~~~~~~~~~~~~~~~~
  233.               This  Setup option will  take you to  a sub menu that allows
  234.               setting up password protection for the entire system and all
  235.               options,  turning the screen blanking  option on or  off and
  236.               setting the  time delay  before going  into screen blanking,
  237.               and also allows editing the screen blanking logo.
  238.  
  239.  
  240.               The Icon Painter Module.
  241.               ~~~~~~~~~~~~~~~~~~~~~~~~
  242.               Icons may be  located  on any  drive or  directory  on  your
  243.               system. Use the  Path Icon  to switch  to the  correct drive
  244.               and directory that you have your Icons located in.
  245.  
  246.               This  Icon  painter should  have no  problems  working  with
  247.               icon lists  of up  to around  700 icons  depending  on  your
  248.               system memory setup. The Icon limit is 700 Icons.
  249.  
  250.               If you experience a  slow down  during  the  display  of the
  251.               Icons,  you may need  to increase the  buffers  statement in
  252.               your CONFIG.SYS file.
  253.  
  254.               A BUFFERS=60 seems to work best with large Icon libraries of
  255.               over 250 icons.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                        Page 3
  262.  
  263.  
  264. -
  265.  
  266.  
  267.  
  268.               Creating New Icons.
  269.               ~~~~~~~~~~~~~~~~~~~
  270.               To create a new Icon,  click on the New Icon  and then enter
  271.               a new Icon filename.  You may begin painting your new Icon.
  272.  
  273.               Edit Existing Icons.
  274.               ~~~~~~~~~~~~~~~~~~~~
  275.               Click  on  the  List  icon,   a list  of all  icons will  be
  276.               displayed,  select an  icon to edit by clicking on the icon.
  277.  
  278.               Delete Icons.
  279.               ~~~~~~~~~~~~~
  280.               To delete an Icon, you must first load it into the editor.
  281.               Use the instructions above for Edit Existing Icons.
  282.  
  283.               Once the Icon is loaded into the editor simply click on  the
  284.               Delete icon to remove it from your system.
  285.  
  286.               Rename Icons.
  287.               ~~~~~~~~~~~~~
  288.               To rename an Icon, you must first load it into the editor.
  289.               Use the instructions above for Edit Existing Icons.
  290.  
  291.               Once the Icon is loaded into the editor simply click on  the
  292.               Rename icon, the icon name will be displayed for changing.
  293.  
  294.               Copy and Move Icons.
  295.               ~~~~~~~~~~~~~~~~~~~~
  296.               To Copy or Move an Icon,  you must  first load  it into  the
  297.               editor. Use the instructions above for Edit Existing Icons.
  298.  
  299.               Click  on the  Copy Icon,   Select  Copy or Move,   From the
  300.               Drive list,  click on the drive you want this Icon copied or
  301.               Moved to.  From the Directory list,  click on the  directory
  302.               you want this Icon Copied or Moved to.
  303.  
  304.               New Path.
  305.               ~~~~~~~~~
  306.               Click on the  Path Icon.  From the Drive list,  click on the
  307.               drive you want to work from.  From the Directory list, click
  308.               on the directory you want to work from.
  309.  
  310.               Save option.
  311.               ~~~~~~~~~~~~
  312.               Clicking on  this option will save any changes you have made
  313.               to the Icon.
  314.  
  315.               The Icon Painter, Tool Options.
  316.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  317.               The tools are  explained beginning  from left to right,  top
  318.               to bottom.
  319.  
  320.               Clicking  your left mouse  button on the color palette chart
  321.               will change the current painting  color to the color clicked
  322.               on.
  323.  
  324.               Clicking  your right  mouse button  will change  the current
  325.               painting color to the color the mouse is on any where on the
  326.               screen.
  327.                                        Page 4
  328.  
  329.  
  330. -
  331.  
  332.  
  333.  
  334.               Curved Lines:  Tool for drawing and painting freehand.
  335.               ~~~~~~~~~~~~
  336.               Straight Lines: Tool for  drawing  Straight lines.  Click on
  337.               ~~~~~~~~~~~~~~~ the tool,  click and  hold mouse button down
  338.                               at the beginning of the line,  while holding
  339.                               the button down, move to the end of the line
  340.                               and then release the mouse button.
  341.  
  342.               Box: Tool for drawing boxes.  Click on  the tool,  click and
  343.               ~~~~ hold mouse button down on the  upper left corner of the
  344.                    box area, while holding the  button down,  move  to the
  345.                    lower right corner of the box area and then release the
  346.                    mouse button.
  347.  
  348.               Filled Box:  Tool for  drawing filled  boxes.  Use the  same
  349.               ~~~~~~~~~~~  instruction for the Box Tool.
  350.  
  351.               Circle: Tool for drawing circles.  Click on the tool,  click
  352.               ~~~~~~~ and  hold mouse  button down  on the  area  for  the
  353.                       center of  the circle,  while holding  mouse  button
  354.                       down, move the mouse  to the  right  to  expand  the
  355.                       circle then release the mouse button.
  356.  
  357.               Filled Circle: Tool for drawing filled circles. Use the same
  358.               ~~~~~~~~~~~~~~ instructions for the Circle tool.
  359.  
  360.               Fill: This tool will change a color on the drawing board  to
  361.               ~~~~~ the color currently selected. Click on the tool, click
  362.                     on  the palette  color selection  for  the new  color,
  363.                     click on the drawing board color you want to change.
  364.  
  365.               Spray: Use this tool to spray  an area on the  drawing board
  366.               ~~~~~~ with the selected color.  Click on the tool, click
  367.                      and hold the left mouse button down to spray.
  368.  
  369.               Clip Board: This tool allows you to clip and save a  portion
  370.               ~~~~~~~~~~~ or all  of an  Icon to the clip board  for later
  371.                           use with the Paste  tool.   Click  on the  tool,
  372.                           click and hold  mouse button  down on  the upper
  373.                           left corner of the clip area, while holding  the
  374.                           mouse button down, move the mouse to the area of
  375.                           the lower right corner of the clip area and then
  376.                           release the mouse button.  The clipped area will
  377.                           be saved to the clip board and will be displayed
  378.                           on the third small window from the right,  above
  379.                           the tools.
  380.  
  381.              Paste: This  tool  allows  you  to  paste  an  area  that was
  382.              ~~~~~~ previously saved to the clip board. Click on the tool,
  383.                     at  this point the  clipped area will be placed on the
  384.                     drawing board along with  your mouse cursor,  move the
  385.                     clip around on the drawing board any place you want to
  386.                     paste  it down  then press your  left mouse  button to
  387.                     paste it down.  Clicking your mouse on an area outside
  388.                     of the drawing screen will cancel the paste operation.
  389.                     You may repeatedly paste a clip down by clicking  your
  390.                     left  mouse button,  moving the clip,  and then  click
  391.                     the left button again to paste.
  392.  
  393.                                        Page 5
  394.  
  395.  
  396. -
  397.  
  398.  
  399.  
  400.              Rotate Clip: Use  this option to flip or rotate a  previously
  401.              ~~~~~~~~~~~~ saved  area to the clip board.  Click  on the up
  402.                           arrow to flip  vertically,  click on  the  right
  403.                           arrow to flip horizontaly,  click on the  angled
  404.                           arrow to rotate the clip.
  405.  
  406.              UnDo: Two undo Icons are  saved each  time you make a  change
  407.              ~~~~~ on the drawing board.  They can be  viewed on  the  two
  408.                    small windows to the right  just above  the tools.  The
  409.                    first window holds the most recent change and the  next
  410.                    window holds the second change.  In other  words,  when
  411.                    you make a change on the  drawing  board,  just  before
  412.                    the change is made,  the first  undo  icon is copied to
  413.                    the second window and the drawing  board icon is copied
  414.                    to the first window.   Clicking your  mouse on the left
  415.                    side of this Undo tool will  replace  the drawing board
  416.                    icon with the left undo icon.  Clicking  your  mouse on
  417.                    the right  side  of the  Undo  tool  will  replace  the
  418.                    drawing board icon with the second undo icon.
  419.  
  420.              Scroll: Use this  tool to scroll the Icon left, right, up, or
  421.              ~~~~~~~ down on the drawing board.
  422.  
  423.              Rotate: Use  this  tool  to  rotate  the drawing  board  icon
  424.              ~~~~~~~ counter clockwise.
  425.  
  426.              Flip: Use this tool to flip the drawing board Icon vertical.
  427.              ~~~~~
  428.  
  429.              Paint Roller: Use this tool to paint the entire drawing board
  430.              ~~~~~~~~~~~~~ area with the selected paint color.
  431.  
  432.              Changing Screen Colors.
  433.              ~~~~~~~~~~~~~~~~~~~~~~~
  434.              From the Main menu, Click on the F1 icon,  then click on Icon
  435.              Painter, from the Icon Painter, click on the asterisk icon.
  436.  
  437.              At this  screen  colors editor,  you will  find eight  screen
  438.              areas  represented, with a slider button to the left of them.
  439.              And  a palette of  66 colors  and 9 gray  scales listed  just
  440.              above them.
  441.  
  442.              To change  a color  simply move  the  slider to the color bar
  443.              representing the screen area that you want to  change. If you
  444.              want to change  the screen color,  click on the Button  icon,
  445.              if you want to change the text color, click on the Text icon.
  446.  
  447.              To make  the color  change,  simply click your  mouse on  the
  448.              color you want to change to.
  449.  
  450.              You can change the  eight different  screen areas or  text to
  451.              any one of the 66 different colors or 9 gray scales.
  452.  
  453.              After changing to the colors you like,  you must click on the
  454.              Save icon to make these changes permanent.
  455.  
  456.              You may  also return  all colors  back to  their defaults  by
  457.              clicking on the less than (<) icon.
  458.  
  459.                                        Page 6
  460.  
  461.  
  462. -
  463.  
  464.  
  465.  
  466.  
  467.  
  468.               Clicking your  left mouse button on the  question mark  icon
  469.               will display user registration information on the registered
  470.               version.
  471.  
  472.  
  473.               Included  with  ToyCHEST I  is an  Icon  conversion  utility
  474.               (CONVERT.EXE)  that  will convert  WINDOWS (.ICO) or  Design
  475.               SHELL (.ICN) icons to the ToyCHEST I 256 color file format.
  476.  
  477.               To use this utility, simply copy the icon files that you want
  478.               to convert in  to the directory  that you are  using for your
  479.               ToyCHEST I icon files.   Also copy  the CONVERT.EXE  file  to
  480.               that directory.
  481.  
  482.               Move to that directory and type: CONVERT
  483.  
  484.               You will  be asked  if you  want to  convert WINDOWS Icons or
  485.               Design SHELL Icons.
  486.  
  487.               At this point,  the Icons will  be listed to  screen one at a
  488.               time and you will be given the option either to  convert this
  489.               Icon or scip it.
  490.  
  491.               If you select to convert the Icon, It will again be displayed
  492.               in it's new format along  with the filename in a text editor.
  493.               You may at this time change the file name or just press enter
  494.               to accept. If an Icon already exist with this name,  you will
  495.               be asked to change the filename.
  496.  
  497.               NOTE !!  The Icons that are converted will still be the same
  498.                        colors of their original ones.
  499.  
  500.  
  501.  
  502.               DISCLAIMER;
  503.               
  504.               Users must accept this disclaimer of warranty:
  505.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  506.               This application supplied as is.  The author  disclaims  all
  507.               warranties,   expressed  or  implied,   including,   without
  508.               limitation, the warranties of merchantability and of fitness
  509.               for any purpose. The author assumes no liability for damages,
  510.               direct or consequential, which may  result from  the use  of
  511.               this manual or the application it describes.
  512.  
  513.               jwh: SoftWare
  514.               6947 Haggerty Road
  515.               Hillsboro,  Ohio   45133           Phone:  (513)393-2402
  516.  
  517.  
  518.               ToyCHEST I is copyright (c) 1993 by:
  519.               jwh: SoftWare all rights reserved.
  520.  
  521.               QuickBASIC is copyright (c) by:
  522.               The MicroSoft Corporation all rights reserved.
  523.  
  524.  
  525.                                        Page 7
  526.  
  527.  
  528. -
  529.